home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / mntdoc01.zoo / mintdoc / cat2 / fchown.nr < prev    next >
Encoding:
Text File  |  1993-03-03  |  1.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. Fchown(2)                 Dec. 12, 1991                 Fchown(2)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        Fchown - change a file's ownership
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        LONG Fchown( char *name, WORD uid, WORD gid );
  12.  
  13. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  14.        _✓F_✓c_✓h_✓o_✓w_✓n  changes  a  file's user and group ownership to _✓u_✓i_✓d
  15.        and _✓g_✓i_✓d respectively. These  ownerships  determine  access
  16.        rights to the file.
  17.  
  18.        Only a process with effective uid 0 or whose effective uid
  19.        matches the user ownership of the file may make this call.
  20.        In  the  latter  case, the new _✓u_✓i_✓d must match the old one,
  21.        and the calling process must also be a member of the group
  22.        specified by _✓g_✓i_✓d.
  23.  
  24. R✓RE✓ET✓TU✓UR✓RN✓NS✓S
  25.        0 on success
  26.  
  27.        EACCDN  if  the calling process has an effective uid which
  28.        differs from the owner of the file and which is not 0.
  29.  
  30.        EINVFN if the file system on which  the  file  is  located
  31.        does  not  support a notion of ownership. (This is true of
  32.        the normal TOS file system.)
  33.  
  34.        EFILNF if the file is not found
  35.  
  36.        EPTHNF if the path to the file is not found.
  37.  
  38. S✓SE✓EE✓E A✓AL✓LS✓SO✓O
  39.        _✓F_✓c_✓h_✓m_✓o_✓d(2), _✓F_✓x_✓a_✓t_✓t_✓r(2)
  40.  
  41. B✓BU✓UG✓GS✓S
  42.        Most file systems don't understand file ownership.
  43.  
  44.        In practice, the call is useful  only  to  processes  with
  45.        effective uid 0.
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. Version 0.92         MiNT Programmer's Manual                   1
  65.  
  66.  
  67.